home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / bgfax160.zip / MAKEFAX.DOC < prev    next >
Text File  |  1996-06-22  |  4KB  |  105 lines
  1.  
  2. Documentation for MAKEFAX, version 1.60
  3. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4. MAKEFAX is Copyright (C) 1993-1996 B.J. Guillot.  All Rights Reserved.
  5.  
  6. MAKEFAX is designed for use with the BGFAX shareware fax receiving/sending
  7. program for DOS and OS/2.                    http://www.blkbox.com/~bgfax/
  8.  
  9.  
  10. Description
  11. ~~~~~~~~~~~
  12. MAKEFAX.EXE (DOS version) and MAKEFAX2.EXE (OS/2 version) will convert
  13. ASCII text files, PCX files, or DCX files into FAX image format so that
  14. BGFAX /SEND mode is able to send the information.
  15.  
  16. MAKEFAX will not run without the font file, BGFAX.FNT.  If the BGFAX
  17. environment variable ("BGFAX") is set, the font file will be looked for
  18. in that directory.  Otherwise, MAKEFAX will search the current directory.
  19.  
  20. MAKEFAX will handle form feeds (Ctrl-L, ASCII-12) in ASCII files, causing
  21. a page break to occur, just as in a printer.
  22.  
  23. Usage
  24. ~~~~~
  25.  
  26.           MAKEFAX file1[+file2[+file3[+...fileN]...]]] outfile.fax [switches]
  27.           MAKEFAX @filelist outfile.fax [switches]
  28.  
  29.                 ************
  30.                 * Switches *
  31.                 ************
  32.  
  33.          /80   use 80-column mode when converting ASCII files
  34.  
  35.          /100  use 100-column mode (this is the default)
  36.  
  37.          /132  use 132-column mode when converting ASCII files
  38.  
  39.          /SP   SHORT PAGES--the fax will end at the last line of text rather
  40.                than padding it out to a full length fax--saves thermal paper
  41.  
  42.        /PL:nn  PAGE LENGTH--in number of text lines on a piece of paper.
  43.                The default is /PL:66 for US-sized paper.  I do not know
  44.                what the A4 is, but I would guess you need /PL:70
  45.  
  46.          /HR   force MAKEFAX to make HIGH-RESOLUTION faxes
  47.  
  48.          /LR   force MAKEFAX to make LOW-RESOLUTION faxes (this is the
  49.                default for ASCII files, but sometimes PCX graphics are
  50.                made for low-resoultion)
  51.  
  52.          /F0   Uses "computer looking" (jagged-edge) font rather than
  53.                nice font when converting ASCII files.  See FNTEDIT.EXE
  54.                (font editor) for a view of the fonts.  I can think of
  55.                no need for using this unless you are just curious.
  56.  
  57.      /PID:nnn  ProcessID number.  Useful if you are running multiple copies
  58.                of MAKEFAX in a multitasking environment.  The nnn will be
  59.                used when creating any needed temporary files so that there
  60.                is no kind of sharing violation.  (See BGFAX.DOC for more
  61.                details on this.  This switch is not needed unless more than
  62.                one copy of MAKEFAX is running on the computer at once.)
  63.  
  64.          /2D   DO NOT USE, for testing purposes only
  65.  
  66. EXAMPLES
  67. ~~~~~~~~
  68.    (a)  MAKEFAX hello.txt hello.fax /sp
  69.         The ASCII text file HELLO.TXT is converted into HELLO.FAX (100-cols),
  70.         but short pages to save thermal fax paper on the remote machine.
  71.  
  72.    (b)  MAKEFAX coverpg.txt+hello.txt output.fax /80
  73.         COVERPG.TXT is the first page, HELLO.TXT is the rest, and they
  74.         are converted into the file OUTPUT.FAX (80-columns)
  75.  
  76.    (c)  MAKEFAX coverpg.txt+bodymsg.txt+lastpage.txt out.fax /132 /hr
  77.         Same as above, except three ASCII files used
  78.         Use 132-columns and high resolution!
  79.  
  80.    (d)  MAKEFAX cover.PCX+porder.txt+thankyou.pcx sendme.fax /132
  81.         This time, the first page is a graphics file rather than ASCII.
  82.  
  83.    (e)  MAKEFAX @list.dat output.fax /80
  84.         The file "LIST.DAT" is used to determine which files are to be
  85.         sent.  Each line of the LIST.DAT file represents a SINGLE filename.
  86.         Only one file is listed per line.  Each line is terminated with a
  87.         standard <CR><LF> (regular ASCII file).  Example LIST.DAT:
  88. cover.pcx
  89. porder.dcx
  90. c:\bgfax\premade\thankyou.txt
  91.  
  92. Additional notes
  93. ~~~~~~~~~~~~~~~~
  94. At present, there is no way to mix text and graphics easily onto the same
  95. page with MAKEFAX.  If you need to do this, look at the public domain
  96. program "2FAX163.ZIP" available off my BBS and web page.  It allows you
  97. to mix multiple fonts, text, graphics, etc.  Very nice utility and comes
  98. with C source code.  MAKEFAX is suiting for most jobs, but if you need
  99. to add some spice to your outgoing faxes, grab 2FAX.  It was designed
  100. specifically for use with BGFAX.
  101.  
  102. Regards,
  103. B.J. Guillot
  104.  
  105.